Summary

Updates agent-facing guidance to reflect the current versioned-CLI-help source-of-truth model and the dogfood findings around iOS Expo Go, keyboard dismissal, field clearing, and same-session command ordering.

Specific changes:

• Makes agent-device help workflow / help dogfood the primary place for workflow guidance.
• Keeps skills/**/SKILL.md as thin routers only: version gate, read the matching CLI help topic, then follow a short default loop. Behavior-specific guidance stays in CLI help so agents without the skill get the same instructions.
• Documents iOS Expo Go guidance: prefer agent-device open "Expo Go" <url> --platform ios when the host shell is known, then verify with snapshot -i so agents do not stop on the runner splash.
• Documents current iOS keyboard dismiss behavior as best-effort with explicit UNSUPPORTED_OPERATION fallback guidance.
• Documents that fill <target> "" is not a supported clear-field command; agents should use visible clear/reset controls or report the tool gap.
• Documents that mutating commands against one session must run serially; only read-only commands or separate sessions/devices should be parallelized.
• Adds/updates SkillGym regression cases for Expo Go host-shell launch, runner-splash recovery, iOS keyboard fallback, empty-fill avoidance, form reset verification, product quantity reads, alert post-dismiss verification, single-command swipe planning, and same-session mutation ordering.
• Aligns website docs, AGENTS.md, and CLI help assertions with the new guidance.

Touched files: 10. Scope stayed within guidance, docs, and SkillGym planning tests.

Validation

• pnpm format
• pnpm exec vitest run src/utils/tests/args.test.ts
• pnpm check:quick
• pnpm build
• SkillGym cases run in batches of 20/20/20/9 via repeated --case runs; all 69 cases passed on codex-mini and claude-haiku
• Post-AGENTS.md sentinel SkillGym cases passed on codex-mini and claude-haiku:
  • expo-go-ios-project-url
  • same-session-mutations-serial
• Review follow-up validation:
  • pnpm format
  • pnpm exec vitest run src/utils/tests/args.test.ts
  • pnpm exec skillgym run ./test/skillgym/suites/agent-device-smoke-suite.ts --config ./test/skillgym/skillgym.config.ts --case same-session-mutations-serial
  • pnpm check:quick
  • git diff --check
• Cleanup validation:
  • pnpm format
  • pnpm exec vitest run src/utils/tests/args.test.ts
  • pnpm exec skillgym run ./test/skillgym/suites/agent-device-smoke-suite.ts --config ./test/skillgym/skillgym.config.ts --case expo-go-ios-project-url
  • pnpm check:quick
  • git diff --check
• Thin-skill-router follow-up:
  • pnpm format
  • git diff --check